Inside Macintosh: Programming With JManager /

Chapter 2 - JManager Reference / JManager Functions

Applet Control Functions /

JMGetAppletName

Returns the name of an applet.

OSStatus JMGetAppletName (
                     JMAppletLocatorRef locatorRef, 
                     UInt32 appletIndex, 
                     JMTextRef* nameRef);

locatorRef

The applet locator that contains the retrieved HTML text.

appletIndex

The index number of the applet you want to query.

nameRef

A pointer to a text object. On return, the nameRef object contains the name of the applet.

function result

A result code; see "JManager Result Codes".

DISCUSSION

The appletIndex value is an index number from 0 to appletCount -1, where appletCount is determined by the JMCountApplets function. You must reserve a buffer for the text object containing the applet name and pass a pointer to the buffer when you call JMGetAppletName. You can call this function only after successfully retrieving HTML text using the JMNewAppletLocator function.

SEE ALSO

"Finding Applets".